home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmSetProtocolHooks.z / XmSetProtocolHooks
Encoding:
Text File  |  2003-11-18  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_S_e_t_P_r_o_t_o_c_o_l_H_o_o_k_s - A VendorShell function that allows pre
  10.       and post actions to be executed when a protocol message is
  11.       received from    MWM
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.       #include <Xm/Xm.h>
  15.       #include <Xm/Protocols.h>
  16.  
  17.       void XmSetProtocolHooks (sssshhhheeeellllllll,,,, pppprrrrooooppppeeeerrrrttttyyyy,,,, pppprrrroooottttooooccccoooollll,,,, pppprrrreeeehhhhooooooookkkk,,,, pppprrrreeee____cccclllloooossssuuuurrrreeee,,,,
  18.             ppppoooosssstttthhhhooooooookkkk,,,, ppppoooosssstttt____cccclllloooossssuuuurrrreeee)
  19.            _W_i_d_g_e_t          sssshhhheeeellllllll;
  20.            _A_t_o_m          pppprrrrooooppppeeeerrrrttttyyyy;
  21.            _A_t_o_m          pppprrrroooottttooooccccoooollll;
  22.            _X_t_C_a_l_l_b_a_c_k_P_r_o_c pppprrrreeeehhhhooooooookkkk;
  23.            _X_t_P_o_i_n_t_e_r      pppprrrreeee____cccclllloooossssuuuurrrreeee;
  24.            _X_t_C_a_l_l_b_a_c_k_P_r_o_c ppppoooosssstttthhhhooooooookkkk;
  25.            _X_t_P_o_i_n_t_e_r      ppppoooosssstttt____cccclllloooossssuuuurrrreeee;
  26.  
  27.       _v_o_i_d _X_m_S_e_t_W_M_P_r_o_t_o_c_o_l_H_o_o_k_s (sssshhhheeeellllllll,,,, pppprrrroooottttooooccccoooollll,,,, pppprrrreeeehhhhooooooookkkk,,,, pppprrrreeee____cccclllloooossssuuuurrrreeee,,,,
  28.             ppppoooosssstttthhhhooooooookkkk,,,, ppppoooosssstttt____cccclllloooossssuuuurrrreeee)
  29.            _W_i_d_g_e_t          sssshhhheeeellllllll;
  30.            _A_t_o_m          pppprrrroooottttooooccccoooollll;
  31.            _X_t_C_a_l_l_b_a_c_k_P_r_o_c pppprrrreeeehhhhooooooookkkk;
  32.            _X_t_P_o_i_n_t_e_r      pppprrrreeee____cccclllloooossssuuuurrrreeee;
  33.            _X_t_C_a_l_l_b_a_c_k_P_r_o_c ppppoooosssstttthhhhooooooookkkk;
  34.            _X_t_P_o_i_n_t_e_r      ppppoooosssstttt____cccclllloooossssuuuurrrreeee;
  35.  
  36.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  37.       _X_m_S_e_t_P_r_o_t_o_c_o_l_H_o_o_k_s is    used by    shells that want to have pre
  38.       and post actions executed when a protocol message is
  39.       received from    MWM.  Since there is no    guaranteed ordering in
  40.       execution of event handlers or callback lists, this allows
  41.       the shell to control the flow    while leaving the protocol
  42.       manager structures opaque.
  43.  
  44.       _X_m_S_e_t_W_M_P_r_o_t_o_c_o_l_H_o_o_k_s is a convenience    interface.  It calls
  45.       _X_m_S_e_t_P_r_o_t_o_c_o_l_H_o_o_k_s with the property value set to the    atom
  46.       returned by interning    _W_M__P_R_O_T_O_C_O_L_S.
  47.  
  48.       sssshhhheeeellllllll
  49.            Specifies the widget with which the protocol property
  50.            is associated
  51.  
  52.       pppprrrrooooppppeeeerrrrttttyyyy
  53.            Specifies the protocol property
  54.  
  55.       pppprrrroooottttooooccccoooollll
  56.            Specifies the protocol atom (or an int cast to Atom)
  57.  
  58.       pppprrrreeeehhhhooooooookkkk
  59.            Specifies the procedure to call before calling entries
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.            on the client callback-list
  75.  
  76.       pppprrrreeee____cccclllloooossssuuuurrrreeee
  77.            Specifies the client data to be passed to the prehook
  78.            when it is invoked
  79.  
  80.       ppppoooosssstttthhhhooooooookkkk
  81.            Specifies the procedure to call after calling entries
  82.            on the client callback-list
  83.  
  84.       ppppoooosssstttt____cccclllloooossssuuuurrrreeee
  85.            Specifies the client data to be passed to the posthook
  86.            when it is invoked
  87.  
  88.       For a    complete definition of VendorShell and its associated
  89.       resources, see _V_e_n_d_o_r_S_h_e_l_l(_3_X).
  90.  
  91.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  92.       _V_e_n_d_o_r_S_h_e_l_l(_3_X), _X_m_I_n_t_e_r_n_A_t_o_m(_3_X), and
  93.       _X_m_S_e_t_W_M_P_r_o_t_o_c_o_l_H_o_o_k_s(_3_X).
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.